PenPixPat

Set the graphics pen pixel pattern

#include <Quickdraw.h> Color Quickdraw

void PenPixPat( ppat );

PixPatHandle ppat ; address of a pixPat structure

PenPixPat is akin to old-style QuickDraw's PenPat, except that it uses

multi colored pixel patterns

ppat is the address of a pixPat structure.

Notes: Using a pixel pattern in an old-style GrafPort results in pat1Data being

placed in pnPat or fillPat.

The PixPatHandle is stored in the GrafPort or the CGrafPort, allowing

Quickdraw to expand the pattern the first time it is set and then putting it

away in a patXData field. After that, it doesn't have to expand it each time

the pattern is set.

Because the PixPatHandle belongs to the port, don't dispose of the handle if

it is set as the pnPixPat. QuickDraw will get rid of all references to it in

all existing grafPorts or cGrafPorts if you do.

You may still set one of the old-style globally- defined patterns, white,

gray, ltGray, dkGray, or black in a cGrafPort by using PenPat.

CGrafPort can create a new pixPatHandle for the pattern. Old-style

patterns are drawn with foreground and background colors when the figure

is drawn, not when the pattern is set.

Referenced by (5):